​
What Is an AI Agent?

An AI agent is a software-based entity powered by large language models (LLMs), designed to understand intent, reason through context, and autonomously perform actions. Unlike traditional rule-based bots, AI agents can dynamically interact with systems, adapt to real-time data, and make contextual decisions. This makes them highly effective in use cases such as:
  • Intelligent customer support
  • Automated internal workflows
  • Context-aware decision-making engines

​
What is an AI Agent Toolkit?

While AI agents bring intelligence, they require tools to take meaningful actions in real-world systems. An AI Agent Toolkit serves as the operational interface — a bridge between the agent’s reasoning capabilities and the infrastructure it needs to interact with. With such a toolkit, agents can:
  • Automatically notify users (e.g., failed transactions, policy changes)
  • Escalate tickets or trigger workflows without human input
  • Send proactive alerts, reminders, or updates using real-time logic
In essence, a toolkit transforms the agent from a passive responder into an active operator.

​
AI Agent Toolkit in Siren

The Siren Agent Toolkit is a lightweight SDK that equips AI agents to integrate with the Siren platform through the Model Context Protocol (MCP). This toolkit empowers AI agents to perform secure, systematic operations across messaging, templates, users, workflows, and webhooks — all within a few lines of code.

​
Key Capabilities

  • Send Messages: Dispatch across channels like Email, SMS, WhatsApp, Slack, In-App, and more — using predefined templates or ad-hoc messages.
  • Manage Templates: Create, edit, and version multi-channel templates with variable support.
  • Control Users: Add, update, or deactivate users and configure their channel preferences.
  • Trigger Workflows: Launch workflows on demand or schedule them dynamically with structured payloads.
  • Configure Webhooks: Handle delivery callbacks and inbound message parsing.

​
Integration Guide

Currently, the toolkit is available in:
  • Python (via PyPI)
  • TypeScript (via npm)

​
Requirements

​
Installation

pip install siren-agent-toolkit
For local development:
# From the python/ directory
pip install -e .

​
Usage

​
Basic Example

from siren_agent_toolkit.api import SirenAPI

# Initialize with your API key
api = SirenAPI(api_key="YOUR_API_KEY")

# Send a simple email message
result = api.run("send_message", {
    "recipient_value": "user@example.com",
    "channel": "EMAIL",
    "subject": "Important Update",
    "body": "Hello from Siren! This is an important notification."
})
print(result)

​
Examples

Complete working examples are available in the examples/ directory:
  • examples/langchain/main.py — Using Siren tools with LangChain
  • examples/openai/main.py — Using Siren tools with OpenAI
  • examples/crewai/main.py — Using Siren tools with CrewAI

​
Development

​
Configuration

The toolkit supports flexible configuration options:
from siren_agent_toolkit.api import SirenAPI

api = SirenAPI(
    api_key="YOUR_API_KEY",
    context={"env": "production"}  # Optional environment configuration
)

​
Building Locally

# From the python/ directory
pip install -e .
# Install development dependencies
pip install -r requirements.txt

​
Running Tests

pytest tests/

​
License

MIT